home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / ACC_CPX / JCLOCK8D / JCLOCK8D.DOC next >
Encoding:
Text File  |  1990-07-28  |  6.4 KB  |  154 lines
  1.  
  2.          -  JCLOCK8D.PRG Documentation  -
  3.             by John L. Stanley
  4.  
  5.              <Wednesday June 7, 1989>
  6.  
  7. ------------------------------------------------------------------------------
  8.       Please read all of this document at least once (even if
  9.     you're already somewhat familiar with JClock).  There are
  10.     several important changes you might miss if you don't....
  11. ------------------------------------------------------------------------------
  12.  
  13.             Program Description
  14.  
  15.   JClock8d installs a tiny (less than 1200 bytes) interrupt handler that
  16. displays an am/pm style clock in the upper right hand corner of the ST
  17. screen.  The "am" or "pm" will display as "AM" or "PM" when CapsLock is
  18. on.  The clock remains on-screen thru all known programs and can be used
  19. in any screen resolution.  The display can be turned on or off at any
  20. time (in any program) with a special keystroke.
  21.  
  22. ------------------------------------------------------------------------------
  23.  
  24. This program solves 6 problems I've had with other ST corner-clock programs:
  25.  
  26.   1) It shows the correct am/pm style time.
  27.  
  28.   2) It can be disabled at any time in any program without rebooting,
  29.      running a separate program, or having to access a desk accessory.
  30.  
  31.   3) It's very small and fast, written totally in 68000 assembly language.
  32.      (Some resident clocks spend too much time in an interrupt.  This can
  33.       cause the keyboard to go crazy sometimes when you move the mouse...)
  34.  
  35.   4) It can be run in any screen resolution and survives resolution changes
  36.      if installed from within the AUTO folder.  (More on this later.)
  37.  
  38.   5) It runs inside any and all ST programs (not just those that obey
  39.      GEM psudo-multitasking rules) and under all known versions of TOS.
  40.  
  41.   6) It doesn't use up an accessory slot.
  42.  
  43. ------------------------------------------------------------------------------
  44.  
  45.               Program Features
  46.  
  47.                 -----
  48.  
  49. CapsLock Indicator...:
  50.  
  51.   When the clock is on-screen and the CapsLock is active, the "am" or
  52. "pm" of the clock display changes to "AM" or "PM" respectively.
  53.  
  54.                 -----
  55.  
  56. Display On/Off Switch...:
  57.  
  58.   Once loaded, the clock display can be switched on or off at any time in
  59. any program using the following key sequence.
  60.  
  61.     Hold down both (Left -and- Right) [Shift] keys FOR AT LEAST 1
  62.     SECOND.  Then, while still holding down both shift keys, hit
  63.     the [CapsLock] key.
  64.  
  65.   If you're using software that already steals the left+right [Shift]
  66. keystroke, holding down [Alternate] with [Right-Shift] and then hitting
  67. the [CapsLock] key will also work...
  68.  
  69.                 -----
  70.  
  71. Screen Resolution Changes...:
  72.  
  73.   JClock (version 8D) will now detect screen resolution changes and
  74. reconfigure itself to display in the new resolution.  (Past versions
  75. caused a garbled clock to be displayed on the screen while running in
  76. the alternate resolution.)
  77.  
  78.   This new feature will only work properly on some machines if you load
  79. JClock from the auto folder.  (During a resolution change, some versions
  80. of TOS will un-install JClock if it wasn't loaded from the auto folder.)
  81.  
  82.                 -----
  83.  
  84. Time-Setting...:
  85.  
  86.   This version of JClock (version 8D) reads the time from the GEMDOS clock
  87. only once when installed.  No amount of altering the system time after you
  88. install the clock will have any effect on the time displayed!
  89.  
  90.   Older versions of JClock read the time from the keyboard clock rather
  91. than the gemdos clock.  This change allows those who have hardware clock
  92. software that only sets the Gemdos time (and Mega users) to run JClock
  93. without needing a special program to set the keyboard time.
  94.  
  95.   This also means that on a 1040 or 520 ST you'll still need to use some
  96. auto folder program to set the Gemdos clock -before- you install JClock.
  97.  
  98. ------------------------------------------------------------------------------
  99.  
  100. "How much does JClock cost...?"
  101.  
  102.   The cost for this program is one postcard.  Picture or plain is up to
  103. you.  If you want, I'll also accept a letter, 3.5" disk, or e-mail...
  104.  
  105.   Why just a postcard minimum-payment?  Why no money?  Because I primarily
  106. want to hear from you to find out who's using JClock, what you like, what
  107. you dislike, and to get ideas for improvements.  I know that most people
  108. look at a "tiny" program like JClock and don't realize what it's really
  109. worth so I don't expect that many people would pay the $2 - $7 that most
  110. authors would ask for it.  Other people just hate to write letters.  I'd
  111. rather make it easy and painless for you to "pay" me so I can tell you're
  112. out there using what I've spent my time creating and just maybe I'll get a
  113. few good ideas for the next version...
  114.  
  115.   If you really like JClock, feel free to send me a letter or disk.  If
  116. you think it's only "ok", then briefly tell me how you would improve it.
  117. Either way, if you use JClock, even if you hate to write, please take 60
  118. seconds to put my address on a postcard along with a stamp, your own
  119. return address, and the word "JClock8d" and drop it in the mail to:
  120.  
  121.         John Stanley
  122.         4157 Lyndale Av. S.
  123.         Minneapolis, Mn. 55409
  124.         USA
  125.  
  126. (I can also be reached on Usenet via john@dynasoft.UUCP or on GEnie as JLS.)
  127.  
  128. ------------------------------------------------------------------------------
  129.  
  130.         -- Disclaimer & Distribution Rights --
  131.      (with much regret that such things are necessary...)
  132.  
  133.   I hereby explicitly disclaim any implied warranty on JClock for any use
  134. what so ever.  JClock is -not- guaranteed to work with any and all ST or
  135. Mega software and hardware.  (The ST has too many unknowns...)
  136.  
  137.   On the other hand, JClock has served the author and many of his friends
  138. (with occasional improvements and enhancements) for well over two years.
  139. If JClock doesn't work with some combination of programs/hardware that you
  140. use, let me know what they are so I can try to fix the problem.  Thank you.
  141.  
  142.   I hereby grant the right to distribute (all together, with -no- changes)
  143. JCLOCK8D.PRG, this text file, and the associated history file via all BBS
  144. systems (local and national), non-profit user groups, and by individuals.
  145. This explicitly excludes all commercial "Public-Domain" distributors and
  146. any other agencies, groups, or companies unless written permission is
  147. granted.
  148.  
  149.                         John L. Stanley
  150.  
  151. PS:  If this is distributed to members of an Atari users group, I'd really 
  152. appreciate if your editor would mail me a copy of your club newsletter. 
  153. After I read it, I'll contribute it to my local users group library.
  154.